<!--
  ~ Copyright (C) 2010 Brockmann Consult GmbH (info@brockmann-consult.de)
  ~
  ~ This program is free software; you can redistribute it and/or modify it
  ~ under the terms of the GNU General Public License as published by the Free
  ~ Software Foundation; either version 3 of the License, or (at your option)
  ~ any later version.
  ~ This program is distributed in the hope that it will be useful, but WITHOUT
  ~ ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  ~ FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
  ~ more details.
  ~
  ~ You should have received a copy of the GNU General Public License along
  ~ with this program; if not, see http://www.gnu.org/licenses/
  -->

<html>
<head>
    <title>Sentinel Toolbox Help - Scatter Plot</title>
    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
    <link rel="stylesheet" href="../style.css">
</head>

<body>

<table class="header">
    <tr class="header">
        <td class="header">&nbsp;
            Scatter Plot
        </td>
        <td class="header" align="right"><a href="../general/overview/SnapOverview.html"><img src="../images/snap_header.jpg"
                                                                                     border=0></a></td>
    </tr>
</table>

<h3>Scatter Plot Display</h3>

<p>
    This dialog allows the user to plot one raster data node against another. See screenshot below for an example.
</p>

<center>
    <img src="images/DensityplotDropDown.png">
</center>

<h4>Mode of operation</h4>


<p>
    For each band, the value range is evenly divided into 512 bins.
    The scatter plot shows these bins plotted against each other, resulting in 512*512 cells.
    For each cell, the number of pixels within the according bands' value ranges is counted and color coded.
    Yellow stands for large amounts of pixels, black for small ones.
    If no pixel is assigned to a distinct cell, the cell will receive no color.
    The color coding can be inverted using the 'Invert plot colors' checkbox.<br>
    The scatter plot will be re-computed when clicking <img src="images/icons/ViewRefresh22.png">.
</p>

<h4>Options Panel</h4>

<p>
    The options panel on the right offers some configuration options. Note that the scatter plot needs to be re-computed
    for changes to the option panel to take effect.
</p>

<ul>

    <li><b>Refresh View <img src="images/icons/ViewRefresh22.png"></b><br>
        Causes the scatter plot to be (re-)computed.
        The button is only enabled when a computation is expected to lead to a different scatter plot than the one on
        display.
    </li>

    <li><b>Collapse/Expand Options Panel <img src="images/icons/PanelRight12.png" border="1"> / <img
            src="images/icons/PanelLeft12.png" border="1"></b><br>
        Collapses or expands the options panel.
    </li>

    <li><b>ROI Mask</b><br>
        A ROI mask may be used to mask out values. All values which do not match the mask are not taken
        into account. For convenience, the mask manager may be openened from the scatter plot window using the
        <img src="images/icons/MaskManager24.png">-button.<br>
        For creating a ROI mask from the scatter plot, see 'Select Mask 'scatter_plot_area'' from the context menu.
    </li>

    <li><b>Auto min/max</b><br>
        For both bands, the minimum and maximum values to be considered during the computation
        of the scatter plot can be set explicitly.
        This can be done by disabling the checkbox for the respective band and entering the desired min- or max-value.
        When the checkboxes are enabled, min- and max-values will be determined automatically.
    </li>

    <li><b>Invert plot colors</b><br>
        Inverts the color range. When selected, large pixel frequencies will be displayed in black, small ones in
        yellow.
    </li>

    <li><b>Zoom all <img src="images/icons/View-Fullscreen22.png"></b><br>
        Adjusts both axes to the full data range.
        The 'Auto range' entry in the context menu can also be used.
    </li>

    <li><b>Edit Properties <img src="images/icons/Edit24.gif"></b><br>
        Allows editing several properties (colors, axes, etc.) of the diagram.
        The 'Properties...' entry in the context menu can also be used.
    </li>

    <li><b>Save chart as image <img src="images/icons/Export24.gif"></b><br>
        Saves the diagram as image (PNG).
        The 'Save as...' entry in the context menu can also be used.
    </li>

    <li><b>Print chart <img src="images/icons/Print24.gif"></b><br>
        Prints the diagram.
        The 'Print...' entry in the context menu can also be used.
    </li>

    <li><b>Help <img src="images/icons/Help22.png"></b><br>
        Displays this page.
    </li>

</ul>

<h4>Context Menu</h4>

<p>A click with the right mouse button on the diagram opens a context menu
    which consists of the following menu items:</p>
<ul>
    <li><b>Properties...</b><br>
        Allows editing several properties (colors, axes, etc.) of the diagram.<br>
        The <img src="images/icons/Edit24.gif"> on the right 'Plot' panel can also be used.
    </li>
    <li><b>Copy</b><br>
        Copies the diagram as image into the clipboard. <br>
    </li>
    <li><b>Save As...</b><br>
        Saves the diagram as image (PNG). <br>
        The <img src="images/icons/Export24.gif"> on the right 'Plot' panel can also be used.
    </li>
    <li><b>Print...</b><br>
        Print the diagram.<br>
        The <img src="images/icons/Print24.gif"> on the right 'Plot' panel can also be used.
    </li>
    <li><b>Zoom In</b><br>
        <ul>
            <li>Both Axes - Zoom in on both axes.<br>
            Zooming can also be achieved by drawing a rectangle by clicking at the top left corner of the desired
            zooming area, dragging the mouse to the bottom right corner, and releasing. Note that this won't work when
            'Select Mask 'histogram_plot_area'' is selected.
            </li>
            <li>Domain Axes - Zoom in only on the domain axis.</li>
            <li>Range Axes - Zoom in only on the range axis.</li>
        </ul>
    </li>
    <li><b>Zoom Out</b><br>
        <ul>
            <li>Both Axes - Zoom out on both axes.<br></li>
            <li>Domain Axes - Zoom out only on the domain axis.</li>
            <li>Range Axes - Zoom out only on the range axis.</li>
        </ul>
    </li>
    <li><b>Auto Range</b><br>
        <ul>
            <li>Both Axes - Adjusts both axes to the full data range.<br>
                The <img src="images/icons/View-Fullscreen22.png"> on the right 'Plot' panel can also be used.
            </li>
            <li>Domain Axes - Adjusts the domain axis to the full data range.</li>
            <li>Range Axes - Adjusts the range axis to the full data range.</li>
        </ul>
    </li>
    <li><b>Select Mask 'scatter_plot_area'</b><br>
        Allows the user to create a mask from the scatter plot.
        After selecting the menu entry, an elliptical selection frame can be created by clicking into the plot,
        dragging, and releasing. The mask will be created according to the values selected, and will immediately be
        selected.
    </li>
    <li><b>Delete Mask 'scatter_plot_area'</b><br>
        Removes the mask 'histogram_plot_area' (in case it has been created before).
    </li>
    <li><b>Copy Data to Clipboard</b><br>
        This will copy the diagram data as tabulated text to the system clipboard.
        The copied text can then be pasted directly into a spreadsheet application
        (e.g. Microsoft&reg; Excel).
    </li>
</ul>

<hr>
</body>
</html>

<!--page visited by UK-->